Goal

Add support for server-side PredefinedFilters to QueryChannels. Apps can now run a channel query by referencing a filter/sort registered on the backend (by name, plus interpolation values) instead of building the FilterObject/QuerySorter on the client. This lets product/backend tweak filtering rules without an app release.

You can check / update / create the predefined filters for the app "Stream Mobile SDK / Stream SDK - Android" - in the "Predefined Filters" section in the Beta Dashboard

Implementation

Public API

• QueryChannelsRequest gains predefinedFilter: String?, filterValues: Map<String, Any>?, sortValues: Map<String, Any>?. When predefinedFilter is set, the client-side filter/querySort are ignored by the backend.
• QueryChannelsResult is a new wrapper around ChatApi.queryChannels that exposes both channels and the backend-resolved PredefinedFilter (parsed name + FilterObject + QuerySorter<Channel>).
• ChannelListViewModel (Compose) and ChannelListViewModel (UI Components) get a new constructor / ChannelListViewModelFactory overload taking predefinedFilterName, filterValues, sortValues. In predefined mode, setFilters/setQuerySort are no-ops; channel search still narrows the displayed list.

State / offline architecture

• New QueryChannelsIdentifier sealed type (Standard / Predefined) is the canonical key used by LogicRegistry, StateRegistry, the listener, and the offline repository. A QueryChannelsRequest/QueryChannelsSpec resolves to one or the other depending on whether predefinedFilter is present.
• QueryChannelsSpec keeps its existing (filter, querySort) constructor (so JVM signatures stay stable) and adds predefinedFilterName/predefinedFilterValues/predefinedSortValues as vars. For predefined queries, those three form the row's stable identity; filter/querySort carry the currently resolved values.
• QueryChannelsMutableState starts predefined queries with placeholder filter/sort and applies the resolved spec via applyResolvedSpec(...) once the backend response arrives (or the row is rehydrated from disk).
• Internal ChannelListViewModel.QueryMode (Standard vs Predefined) drives the two flows — pagination, refresh, search, and filter-flow wiring branch on it.

Persistence

• QueryChannelsEntity gains predefinedFilterName/predefinedFilterValues/predefinedSortValues. QueryChannelsRepository.selectBy(identifier) replaces the previous filter-based lookup.
• Room DB version bumped to 104 (destructive migration, in line with the rest of the SDK).

Wire format

• FilterDomainMapping now supports a full round-trip (DTO ↔ domain) so the resolved predefined filter coming back from the server can be parsed into a FilterObject and stored.

Testing

• Unit tests added/updated across the new boundaries: QueryChannelsIdentifier derivation, MoshiChatApi, FilterDomainMapping (round trip), QuerySortByField round trip, DatabaseQueryChannelsRepository, QueryChannelsLogic / QueryChannelsDatabaseLogic / QueryChannelsListenerState, QueryChannelsMutableState, LogicRegistry, and both ChannelListViewModels.
• Both sample apps (Compose and UI Components) are wired to a backend-registered android_sample_filter so the feature can be exercised end-to-end on device.